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Liting Policy enna Dees $46.00 

One "sample" copy sent upon receipt of Business size SASS. 
Copies provided on EXCHANGE BASIS with other bona fide user 
groups. LISTing is published monthly except July and August by 
LIST (Long Isiand Sinclair Timex) Group, a not for profit user group. 

We are always looking for articles, programs, reviews etc. to keep our 
members informed and entertained. You maintain full credit and copyright. 

Portions if this publication may be reproduced, without written consent. 
Please give credit to LIST when reprinting articles. 

LIST disclaims any responsibility for any damage you may do to your 
computer as a result of reading any articles in LISTing. 
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October 19th 1993 


Fred Stern 
214 Roberts Street, 600) HENS 
Holbrook, NY 11741 


Hi Fred, 


I couldn't locate the address for JD Hannam CO; However, I have 
their toll free telephone number: 800-228-0308. They are located 
in California and provide excellent service. I searched for my 
bills from JD Hannam CO which had their address on them, but I 
could not find them. 


It may be a good idea if you telephone them and verify the prices 
I had quoted at our last LIST meeting. 


TEAC FD235J 3653 3.5" ED drive @ $75.00 

TEAC 3.5", 720K, DSDD drive @ $25.00 

They come with beige face plates, however a black face plate can 
be exchanged for a $2.00 exchange charge. 

5.25" complete mounting kit for all 3.5" drives @ $6.00. 


In the latest issue of Nuts N’ Volts, ALLTECH Electronics Co., 
Telephone: 800-995-7773, have the following 'Good Buys’: 


External Floppy Drive Case with power supply for two half-height 
drives or one full-height drive, $19.00. 

Surplus/Bulk floppy disks: 5.25" DSDD disks (usually format 
720K), 100 disks for $12.00. 

3.5"DSDD 720K, 50 disks for $14.50, 10 disks for $3.90. 

The disks may have been programmed disks, however, I am not sure! 
They have three locations: 

1300 East Edinger, Unit D, Santa Ana, CA 92705: Tel 714-543-5011 
2018 West Lomita Blvd., Lomita CA 90717: Tel 213-539-2260 

602 Garrison Street, Oceanside, CA: Tel 619-721-7733 


I do not know which location will ring for the toll free 800 
number stated above. I have had purchased items from them in the 
past and they do advertise monthly in Nuts N” Volts mag and are 
reliable! 


Regards 
faf- 
Bob Gilder 


QL CORNER 


DJTOOLKIT REVIEW Author: Norman Dunbar Reviewed by Bob Gilder. 


I became interested in the DJToolkit after browsing through the Dilwyn Jones 
Computing ads in the last issue of IQLR. It was as though the author of this 
software had me in mind - the toolkit was totally compatible with the QLiberator 
compiler. Turbo and Supercharge can also benefit from the DJToolkit, with the 
exception of one command, DEV_NAME. This function tends to modify its 
Parameters as well as returning a string. 


The DJToolkit is very easy to use , provides 44 useful extensions and is 
extremely powerful. The Toolkit is less than 4 Kbytes long. There are several 
versions of the Toolkit: DJToolkit_BIN which is booted into the reserved memory 
area, DJToolkit_rom is a file that can be burned onto a 27128, 16 K eprom and 
DJToolkit_rpm for those users who may wish to add their own header with 
Liberation Software's Resident Program Manager software (RPM). A lot of thought 
went into this software package to benefit a wide variety of the software user's 
requirements. 


A 20 page manual accompanies the disk, providing a brief description of the new 
commands as well as detailed description for each of the new functions and 
procedures. Quite a few SuperBASIC listings are provided in the detailed 
section of the manual, that can be used as demonstrations for some of the 
toolkit extensions. 


Updates_doc is an extension of the DJToolkit Manual. This document provides 
latest updates that were added to the toolkit, but were added too late for 
insertion into the manual. 


The Toolkit areas covered include screen handling, file handling, file and date 
extensions, environment functions (free memory, pointer environment detection, 
check if given SuperBASIC extensions are present, check if level 2 device 
drivers are present), common heap extensions, font handling extensions, file 
headers, memory block move and search functions and general programming aids 
such as system variable address function, screen base address function, display 
width function for dealing with new graphics hardware and so on. 


Outlined below is a brief description of the new procedures and functions as 
outlined in the manual: 


ABS_POSITION Set file position absolute. 

BYTES_FREE How much free memory is left, in bytes. 

CHECK Test to see if machine code PROC/FN exists. 
DEV_NAME Scan the Directory Device list, returning next name. 
DISPLAY_WIDTH How many bytes used to hold one screen line? 
DJTK_VERS Return the toolkit version number as a string. 
FETCH_BYTES Get some bytes from a channel. 

FILE_BACKUP Get some backup date for a specific file. 
FILE_DATASPACE Get the file's dataspace. 

FILE_LENGTH Get the file's length. 

FILE_POSITION Get the current position in the file. 
FILE_TYPE Get the file's type. 

FILE_UPDATE Get the file's update date. 

FLUSH_CHANNEL Flush the data on a channel to a device. 
GET_BYTE Fetch one byte from a channel. 

GET_FLOAT Fetch 6 bytes -from a channel. 

GET_LONG Fetch 4 bytes from a channel. 

GET_STRING Fetch a QDOS string from a channel. 

GET_WORD Fetch 2 bytes from a channel. 

KBYTES_FREE How much free memory is left in Kbytes. 

LEVEL2 Test whether level 2 drivers are present on a channel. 


MOVE_MEM Move memory around. 


There are two very important files included on on the disk; DEMOS_bas and 
DEMOS_doc. DEMOS_bas is a 37K SuperBASIC file chocked full of useful procedures 
and functions using a variety of the DJToolkit extensions. DEMOS_doc supports 
it's SuperBASIC counterpart as it provides detailed instructions for use of each 
procedure and function in the order that they are programmed. 


For owners of the QLOAD utility, the file DEMOS_sav can be loaded with the QLOAD 
command. 


I would strongly advise the new user to print out the DEMOS_doc file for use 
with DEMOS_bas or use a multi-tasking front end, activate Quill, load in the 
DEMOS_doc file, CTRL-C into basic and load in the DEMOS_bas file. List the file 
and CTRL-C back and forth for instructions and operation. 


Incidentally, all of those procedures and functions supplied on DEMOS_bas can be 
extracted and used within other programs. I extracted one 8-line procedure 
called 'AUTO_REPEAT' which uses the SYSTEM_VARIABLES function. I have an 
external Schoen Keyboard interface which suffers from keyboard 'roll-over' or 
repeat characters. Several different remedies have been tried throughout the 
years with out a correction for this problem. AUTO_REPEAT did the job! For me - 
the DJToolkit was well worth the purchase price of £10 for correcting this 


nagging problem. 


There are many more useful routines within DEMOS_bas. Some of my favorites are: 
SLIDE_SHOW for viewing a number of screen dumps, FILE_DETAILS and DRIVE_DETAILS, 
MAKE_DIRECTORY for Level2 sub-directories, FIND_FILE lists the filename of files 
containing a user input string on the screen and a short extract of the file on 
either side of the string that was found. I'm sure that the many other routines 
nested in this program that would suit every QL user. - 


Four fonts are provided for use with the USE_FONT procedure. This procedure 
allows the user to change the standard QL character set within any channel. 
Fonts from Digital Precision's Lightning and Dilwyn Jones Computing Page 


Designer can also be loaded and used. 


The DJToolkit is compatible with Toolkit2. Activating TK2_ext and typing 
"EXTRAS' will reveal the DJToolkit commands nested within the other functions 
and procedures. 


The author of DJToolkit allows any legal owner of this toolkit to include it in 
QLiberator compiled programs even if you intend to sell commercially or give it 
away as public domain software or as shareware, by linking it to the program. 


The software package is available on disk or microdrive cartridge and will 
operate on an unexpanded QL. 


The author, Norman Dumbar and Dilwyn Jones have made this software package 
'idiot-proof', it is that easy to use. The whole software package; the Toolkit 
and its supporting documentation and demo program and SuperBASIC listings make 
the use of DJToolkit very easy, even for a novice QL user. Most software 
manufacturers seem to prepare their supporting documentation for users at their 
own level, forgetting that, perhaps, there are QL users out there that require 
simple step-by-step instructions just to get a "grip' on it. It's obvious that 
the team of Norman Dumbar and Dilwyn Jones really understand this problem 
empathizing with the vast majority of software users. 


The DJToolkit is powerful, easy to get going and a steal at £19.00. Buy it! You 
won't regret this purchase. 


The DJToolkit is available from: Dilwyn Jones Computing, 41 BRO EMRYS, 
TAL-Y-BONT, BANGOR, GWYNEDD, LL57 3YT, Great Britain Tel: 0284-354023 
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ARTICLES 


T/S 2868 


SPDOS or yet another 
disk DOS. 
By Donald S. Lambert. 


Way back when there was a disk 
interface for the T/S 2868 
called Ramex Millenia K. See 
UPDATE for January 1988 page 8. 
SPDOS was originally marketed by 
WATFORD ELECTRONICS as a disk 
interface and operating ysytem. 
KEPSTON later marketed a version 
which used a smaliar amount ct 
RAM, approx. 7009 bytes (WATFORD 
used about 8K). A varient of the 
SPDOS interface was marketed in 
North America by Ramex 
International, LTD and known as 
the MILLENIA K. The SPDOS 
presently being marketed by the 
CUYAHOGA VALLEY SOFTWARE WORKS 
is a modification of SPDOS for 
the 2868 running on. Oliger 
hardware. It is sold under 
license from ABBEYDALE DESIGNERS 
LTD,. who wrote SPDOS. 


It is still available from 
CUYAHOGA VALLEY SOFTWARE WORKS; 
615 SCHOOL AVE.; CUYAHOGA FALLS, 
OHIO 44221 for $24.95 plus $1.58 
postage. Currently it _ is 
available through CVSW only on 
8@ track 5.25 disks but I could 
help make it available on 48 
track 5.25 disks. The package 
will consist of two disks and a 
3@ page manual. 


The first disk is just a few 
files and it converts the Oliger 
disk system to accept SPDOS. 
Then you place the SPDOS boot 
disk in the first drive and 
press enter and there is the 
SPDOS screen and you are ready 
to work with SPDOS. While the 
Larken and the Oliger number the 
disks @, 1, 2, and 3; SPDOS 
numbers the drives 1, 2, 3, and 
4. And you have to use drive 1 
(SPDOS #1 not Oliger #1) for the 
boot disk. In fact there are 


many things that require that 
drive to have the SPDOS boot 
disk in drive 1. The commands 
are very similar to Larken 
except that you can only use 
PRINT #4:command: X.X. 


The main differences that you 
will find are that this is a RAM 


based DOS and it is in memory 
from 383598 thru 63300. It 
supports sequential files and 


also program overlays. 


One main difference in the DOS 
is that SPDOS FORMATS a track to 
ten 312 sectors and the minumum 
SAVE to disk is 1K. Then there 
is a maximum of 144 files to a 
disk and if the disk is not a 
data disk the first 15K is not 
useable for SAVEing a file to 
since it will have the BOOT 
program there. : 


The only problem I had with 
SPDOS was in copying the disks 
using MOVE. The manual gave the 
following: 

“83 PRINT 


PRINT #4: MOVE "", 


di,d2 


but when I tried it I got ERROR 
messages mostly var not found. 


I messed around and tried this 
and that with more ERROR 
messages. I finally called 
Thomas Simon and he looked it up 
in the manual and aha! this is 
what I was supposed to have 
used: 


PRINT #4: MOVE "", "", PRINT 1,2 


or whatever drives you are 
copying from and to. ; 
It worked, and when I asked 


Frank Davis about it he said he 
had the same problem. 


either 
the 
the 


To FORMAT a disk you can 
use the FORMAT that is in 
SYSCOPY program or use 
following: 


PRINT. #4: FORMAT “disk name": 
PRINT (number of the drive to be 
formatted 1-4), (the number of 
tracks of that drive 35, 480, 
88), (the number of sides on the 
drive 1 or 2), (and the stepping 
rate 1-4 with 1=6MS, 2=12MS,. 
3=20MS, 4=30MS) 


I have a version of MSCRIPT that 
works with SPDOS but it has had 
the memory shortened so that it 
has about 2 1/2 pages of text or 
ROOM in memory 9627. But it 
works. 


And now I have a copy of TASWORD 
that works with SPDOS. But it 
does have a limited file size. 


And my thoughts about SPDOS is 
that while it works it is not 
friendly like either the Larken 
or the Oliger DOS in that it is 
software only and it uses up 11K 
of memory. I now know what the 
MSDOS users go through. First 
you load the software that 
prepares the Oliger for SPDOS 
and then you LOAD SPDOS. And 
SPDOS is not bashfull about 
reporting an error code which 
you seldom see with either the 
Larken or the Oliger. It is a 
joy to use a real user friendly 
disk operating system. 
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At the Next LIST Past 


“It must have been a power surge.” 


Bug Reports And Other ZX-TS Ponderings 


When you are a beginner or just a creative hobbyist trying to delve deeper 
into how computers work, you can easily get fooled by believing that since an 
expert produced the book, it cannot be wrong if something does not make sense, 
Well experts cannot be experts in everything and they can make mistakes. Witness 
a magazine article, some technical books by professors and a'book on 0S/2 which 
got some basic facts wrong to. count about a dozen errors this writer has found 
recently in print. For the Sinclair enthusiast, here are a few more of interest 


old ZX-81 manual, p.184 (notin newer TS manual) code 135 is (g- not By 
in the ZX-81 LDOS disk manual sort is 14480 and CLINE is 12316 or should. 


old ZX-81, 2 volume version of Dr.Logan's ROM disassembly there are a 

Í number of misprints in addresses, so before calling one in 
a me call routine, look at the previous and next address to 
see if it makes sense (as in p.2, both FP-CALC and the END-CALC 
following are given the same ROM address 0028 hex, while the.. 
second should be @@2B). All m/c addresses of any book are suspect! 


Not to be outdone, our LDOS Unofficial Technical Manual has included a few 
(this is a ZX-81/T31000 only book), in the different versions that have come 
out. Even some very early versions of the simple instructions on using the 
System for beginners, contained some mistaken advice, that was pointed out to 
me by early reviewers, Also, picking up reports that subway train motors can 
erase disks was a mistake that was pointed out, the story possibly originating 
as an imaginitive excuse to Someone's boss to explain why the work to be done 
at home was not on the boss! desk the next morning. One of those urban myths 

erhaps. A specific error in the section on converting commercial programs 
trace 3-4 in some versions) quoted SAVE CHR... instead of LOAD CHR3 332" as 
the way to get an unbreakable program to break, the break key halting it when 

it pauses after loading before going into a save. Another mistake was in saying 
that you could PEEK to CLINE after an operation to get the. file name last saved 
under, when in fact this is partially overwritten with temporary data during the 
course of disk" access. This publishing hobby can certainly keep one «sharp. 

Then there are problems ‘in the ZX-81/TS1000 itself, The occasional error 
with floating point divide is fairly well known, but some early ROM versions 
will make other mistakes like giving 1.359 for PRINT SQR D.25, when everyone 
knows the square root of 1/4 should be something like 9.5 (Y times 1 =1), It 
seems that Sir Clive Sinclair was an enthusiast for finding new, smaller m/c 
programs for getting math functions, having been able to squeeze some scientific 
functions into the small ROM of a pocket calculator, in a way people thought 
could not be done, and doing it in record time from a motel room in the USA near 
the chip manufacturer's plant, that was waiting to start production. The most 
obvious mistake in the ZX-81/TS1000 ROM is the CLS going nuts when used after 
some scrolling, in certain situations, However the Sinclairs were not the only 
computer to have some software bugs, as MS DOS in versions below 2 and the BASICA 
that goes with it had enough bugs that owners were advised to upgrade to version 
2 in the early days of the IBM PC. One can probably consider oneself lucky if 
one only makes a few errors in a project as exacting as computer work. The 
Coleco Adam computer for example has had its BASIC fixed extensively by local 
amateurs working out of the user groups. One problem it once had,is forgetting 
which parts saved on a cartridge or disk belong to the latest or an older, 
deleted version of an essay or text, To lose the whole thing.as a result, not a 
nice thing when you are working to a deadline. (And would the teacher believe 
you if you said it was all finished, but the computer lost it? Maybe he would 
take the subway motor erased it story as more believable afterall.) 

Finally, in the last issue (TS Bulletin #2-92) an indexed sorting routine 
was listed for educational purposes, It occurred to me that RAM could: easily :be 
saved by replacing the array N(X), DIM N(NE) of numbers with the string array 
N3(X), so that DIH N3(NE,1) would save 4 bytes per element (record,in the data- 
base). This would limit records to about 253 and the comparisons etc. would 
nave to be chanzed to IF OP AND I3(CODE(N3(X)) )(3 TO 23)<=I.3(CODE((N3(Y))))(3 TO 
23) THEN GOTO 225 from 202 IF OP=1 AND I3(N(X))(3 TO 23)<=Iš(H(Y))(3 TO 23) THEN 
GCTO 225, and similar changes to the other ç mparissns, etc, and switch routines 
at 210 and 280. 110 also becomes 110 IET iS TZ) CHAS Z étc. 

So look out for our little friend the computer bug; he is everywhere} 


REH © WAEL SABRAGH 
DIM AS(3S0,8,208) 
LET FCF=1 

PAPER 1: 


BORDER 1: INK 6: C 


POKE 23658,8 
PRINT AT 16, 8; FLASH 1; “FIL 


PRINT AT 11,3; "BY UAEL Sansa 
INPUT “SECRET CODE TO ENTER 


4&2 
TO FILES”; Bs 
SO IF B3<>"PMP" THEN BEEP .3,- 
e 


@, 1a; "MENU" 
TO OPEN R NEN FILE 


TO LOOK AT A CERTA 


120 PRINT 3 TO HAVE A LOOK AT 
EACH FILE (ON LY FILE CODE AND N 
AMEIAT THE SAME TIME" 

n 1=@ PRINT “4a SAVE FILES ON TAPE 

135 PRINT 

140 PRINT "S LPRINT A FILE ON T 
HE PRINTER" 

150 PRINT “6 SEARCH THROGH ALL 
F L£ r. ° 

155 PRINT 

152 PRINT “7? CHANGE INFORMATION 

FROM FILE” . 

7S PRINT : PRINT “8 STOP” 

INPUT “CHOICE PLEASE (1:82”" 


00000000 
0 0018 OWE 


DH H H H H H H H 


130 

FOO CODE ","NAME ”“” ,“ 
|, “TOU si , “COUNTRY ” “PO 
| TELEPHONE “2 . "OTHER ° INF 


a“ 
Sia CLS : RESTORE 3009 

315 IF FCF>30 THEN BEEP 1,4: P 
RINT °° ,“NO PLACE FOR RATA": GQ 
TO 4108 
Z LET ASTFCF,13) =STRS FCF 
PRINT AT 0,3; “NEW FILE ENTF 


PRINT REAC BH: PRINT B*; F 


FOR X=2 TO 8: READ BS 
INPUT (68%) ;AKi(FCF.X} 
IF LEN AS(FCF,X)>2@ THEN GO 
35a 
STG PRINT B$:AS(FCF,™X) 
3800 BEFP .2,Xx5 
390 PRINT 
49Q@ NEXT X 
405 LET FCF=FCF+1 
419 PRINT FLASH 1; "PRESS ANY KE 
Y TO GO TO MENU" 
420 IF INKEY$="" THEN GO TO 429 
438 GO Ta se 
5090 CLS 


SAS CRINT AT @,7; “FILE DISPLAY” 


PRINT “HIT 4 TO 


540 IF INKEY $=""" THEN GO TO 
S50 IF INKEY ==" 1” 

TLE CODE “;F: LET U=1: 

S60 IF INKEY$="2" 

nne PLEASE “;F*: LET U=2: 

S570 IF INKEY$="S3" THEN INPUT 
s= PLEASE rá: LET U=?%: GO TO 


S71 IF INKEYS$="4" THEN GO TO 66 
S72 GQ TO s4a 
575 FOR X=LEN care TO 2@: LET F 
S=FS+° “: NEXT 
580 FOR X=1 TO ECF: IF AS(X,V)I= 
F$ THEN LET F=X: GO TO 7009 
SƏ@ NEXT X d 
CLS 
PRINT "NAME + TEL NOT IN FI 


GO TO S228 
RESTORE 380: CLS 
READ B$: PRINT BSiF 
FOR X=2 TO 8 
PRINT 
READ B$: PRINT INK 6;8 
-92,X#2: PRINT INK 7jA$ 
BEEP 702,X#3 
750 XT X 


CLS 
PRINT FLASH 1; “NAME”, “FILEC 


FOR X=1 TO FCF 


PRINT AS (X,2);° “AŞIX, D) c 


CLS 
PRINT AT @,5; "SAVE FILE ON 


INT : PRINT 
INT “INSERT BLANK TAPE” 
BRINT “THEN PRESS ANY KEY” 
BF INKEY$="" THEN GO TO 118 


dave AA LINE 10 


PRINT “REWIND TAPE TO VERIF 


‘PRINT “THEN PRESS ANY_KEY” 
¡IF INKEY $=""" THEN GO TO 121 


UERIFY a 
AT 90,4; “PRINTER 
1529 PRINT : PRINT FLASH 1; "IF Y 
OU ARE NOT SURE OF FILE cobe THE 
NOSE OPTION 3 (ON MENU? TO FIND 
1548 PRINT : PRINT “PRESS P TQ P 


RINT FILE ON PRINTER” 
qo PRINT “PRESS M TO GO TO MEN 


16K Spectrum has been sent by 

Wael Sabbagh of Colchester. 
Spectrum File provides a method of 
storing the names and addresses of up to 
30 individuals. Only 20 characters can 
be handled on each line of input but 
that should be no disadvantage, except 
perhaps on the Other Information line. 

Since some of the information in the 
file may be confidential, the files can be 
accessed only when the secret code has 
been entered. STOP and LIST com- 
mands would allow the Sinclair user to 
crack that deadlock quickly. The code 
as listed is PMP but can be altered in 
line 50. The routine is served by a very 
useful menu. 

As with all filing routines, the user is 
well-advised to avoid RUN commands. 
If the program is broken into, then GO 
TO 60 will return you safely to the 
menu. . 

On a 48K machine, the routine will 
handle details on 150 individuals pro- 
vided the number 30 in lines 35315; 
1590 and 2520 is altered to 160. If the 
program is to be saved, option 4 of the 
menu should be used. 


A VERY USEFUL routine for the 


1560 IF INKEYS$<>"P" AND INKEYSx> 


“HU THEN GO TO 1560 


1570 IF INKEY$="" THEN GO TO 41 
e 


1550 INPUT "ENTER FILE CODE ";F 
1599 IF F<1 OR F>32@ TREN GO TO 
SEO 


15699 RESTORE 308: LPRINT “SABRAG 


H SOFTWARE FILE PROG" 
1610 LPRINT 

1628 FOR X=1 To S : : 
1659 READ K$: LPRINT KS; AS(F,&) 
15649 LPRINT 

1650 NEXT x 

1660 LPRINT “_ 


1670 GO TO 63 

2804 CLS 

2010 FOR X=1 TO FCF-1 
2029 RESTORE 300 
2959 FOR K=1 TO 5 
20640 READ BS 

2050 PRINT B*$;F_R*$(X,K) 
2060 PRINT : NEXT K 


21@@ PRINT FLASH 1: "PRESS ANY KE 


Y TO CON ¿(H TO MENU)" 


< <= 
.- > 
<LI 
a 


— 


we 


IS 


IF INKEY$=""" THEN GO TO 214 


í 
IF INKEYS="M" THEN GO TO se 
CLS : NEXT X 
GO TO 418 

RESTORE 308: CLS 

INPUT “UHAT FILE WOULD YOU 
TO CHANGE INFO FROM ";F 

IF Fei OR F>38 THEN Gd To 2 


PRINT FLASH 1; “WHAT WOULD y 
OU LIKE TO CHANGE" 
2540 PRINT “INPUT 9 TO GO TO MEN 
ue 


2550 FOR C=1 TO 8 
2555 READ 8H 
2S6Q PRINT FLASH 1,0, FLASH 0:85 
¡¿AS(F,C) 
2570 NEXT C 
INPUT “CHANGE (9 TO MENN ”; 


IF D=9 THEM GO TO 2 
INPUT “THE NEU VERSION"; As;< 


RESTORE 30@: GQ Ta 2s 


CLS : PRINT AT 18,4; FLASH 
i; “FILE CLOSED” 


